package com.ruoyi.fun.mapper;

import java.util.List;
import org.apache.ibatis.annotations.Param;
import com.ruoyi.fun.domain.EcUserCoupon;

/**
 * 用户优惠券Mapper接口
 * 
 * @author ruoyi
 * @date 2025-08-15
 */
public interface EcUserCouponMapper 
{
    /**
     * 查询用户优惠券
     * 
     * @param userCouponId 用户优惠券主键
     * @return 用户优惠券
     */
    public EcUserCoupon selectEcUserCouponByUserCouponId(Long userCouponId);

    /**
     * 查询用户优惠券列表
     * 
     * @param ecUserCoupon 用户优惠券
     * @return 用户优惠券集合
     */
    public List<EcUserCoupon> selectEcUserCouponList(EcUserCoupon ecUserCoupon);

    /**
     * 新增用户优惠券
     * 
     * @param ecUserCoupon 用户优惠券
     * @return 结果
     */
    public int insertEcUserCoupon(EcUserCoupon ecUserCoupon);

    /**
     * 修改用户优惠券
     * 
     * @param ecUserCoupon 用户优惠券
     * @return 结果
     */
    public int updateEcUserCoupon(EcUserCoupon ecUserCoupon);

    /**
     * 删除用户优惠券
     * 
     * @param userCouponId 用户优惠券主键
     * @return 结果
     */
    public int deleteEcUserCouponByUserCouponId(Long userCouponId);

    /**
     * 批量删除用户优惠券
     * 
     * @param userCouponIds 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteEcUserCouponByUserCouponIds(Long[] userCouponIds);

    /**
     * 根据UserCouponID和组织ID查询UserCoupon
     * 
     * @param userCouponId UserCoupon主键
     * @param orgId 组织ID
     * @return UserCoupon
     */
    public EcUserCoupon selectEcUserCouponByUserCouponIdAndOrgId(@Param("userCouponId") Long userCouponId, @Param("orgId") Long orgId);

    /**
     * 根据组织ID查询UserCoupon列表
     * 
     * @param ecusercoupon UserCoupon
     * @param orgId 组织ID
     * @return UserCoupon集合
     */
    public List<EcUserCoupon> selectEcUserCouponListByOrgId(@Param("ecusercoupon") EcUserCoupon ecusercoupon, @Param("orgId") Long orgId);

    /**
     * 根据用户ID和组织ID查询用户优惠券列表
     * 
     * @param userId 用户ID
     * @param orgId 组织ID
     * @return 用户优惠券集合
     */
    public List<EcUserCoupon> selectEcUserCouponListByUserIdAndOrgId(@Param("userId") Long userId, @Param("orgId") Long orgId);

    /**
     * 根据订单号查询用户优惠券
     * 
     * @param orderNo 订单号
     * @param userId 用户ID
     * @param orgId 组织ID
     * @return 用户优惠券
     */
    public EcUserCoupon selectEcUserCouponByOrderNo(@Param("orderNo") String orderNo, @Param("userId") Long userId, @Param("orgId") Long orgId);
}
